node_modules/hexo-theme-kira/
)今天不用做任何事就看對照表而已
之後有要修改不知道要改哪個檔案都能回來這邊看
路徑 / 範例檔名 | 作用 | 影響頁面 | 自訂建議 / 備註 |
---|---|---|---|
layout/index.ejs |
首頁框架(封面、文章列表) | 首頁 | 增加共用元件。 |
layout/post.ejs |
單篇文章版型 | 文章頁 | 文章內資訊欄、目錄、標籤顯示都在這控制。 |
layout/archives.ejs |
歸檔頁版型 | /archives |
改排序或群組樣式。 |
layout/about.ejs |
自我介紹頁 | /about |
點頭像跳轉到自介頁會連到這個 layout。 |
layout/friends.ejs |
友鏈頁版型 | /friends |
卡片樣式、分欄、載入圖都在這裡。 |
layout/components/sidebar.ejs |
側欄結構(頭像、社交、分類…) | 所有頁 | 滑鼠移到頭像旋轉、點擊跳轉事件可在這裡掛。 |
layout/components/header.ejs |
頂部導覽列 | 所有頁 | 更改頭像特效與設定 |
layout/_widget/social.ejs |
社交連結渲染 | 所有頁 | 讀取主題設定的社交清單;換 icon/新增平台 |
languages/*.yml |
多語系字串 | 所有頁 | 介面文字翻譯;臺灣繁中用 zh-TW.yml 。 |
source/css/layout.styl 等 |
主要版面排版 | 所有頁 | 不直接修改這個文檔,而是引用 source/style.css 將新增的介面加在這邊 |
source/css/post.styl |
文章區塊樣式 | 文章頁 | 文章區標題、引用、程式碼區塊樣式。 |
source/css/sidebar.styl |
側欄樣式 | 所有頁 | 頭像外框、hover 動畫、社群列版面。 |
source/js/kira-code-copy.js |
程式碼複製按鈕 | 文章頁 | 更改按鈕圖示或文案。 |
source/js/kira-image.js |
圖片互動/燈箱 | 圖片元素 | 若要禁用某些頁的燈箱,這裡可加判斷。 |
source/lib/iconfont/* |
圖示字型與示例頁 | 所有頁 | 放 SVG/Iconfont;可替換為官方 SVG。 |
source/lib/lazysizes/* |
圖片延遲載入 | 有圖頁面 | 若相容性問題,版本在這。 |
scripts/tag/*.js |
Hexo 自訂標籤(aplayer、bilibili、codepen…) | Markdown 文章中使用 | 用 {% aplayer %} 等標籤時由這裡產生 HTML。 |
package.json / README / LICENSE |
主題資訊與授權 | — | 了解相依與用法。 |
路徑 / 檔名 | 作用 | 影響頁面 | 自訂建議 / 備註 |
---|---|---|---|
_config.yml |
站點總設定(標題、語系、分頁… & 指定 theme: kira ) |
全站 | 改站名、網址、分頁數、啟用插件。 |
_config.kira.yml |
Kira 主題專屬設定(社群連結、封面、配色、元件開關) | 全站 | 建議優先用這裡調整,不動主題原始碼。 |
source/about.md |
自我介紹內容 | /about |
Front-matter layout: about ;內容自己寫 |
source/friends.md |
友鏈清單資料 | /friends |
Front-matter layout: friends ;可用陣列生成卡片 |
source/archive.md |
歸檔入口頁 | /archive 或 /archives |
Front-matter 指向對應 layout |
source/style.css (或 source/css/_custom.styl ) |
你的覆寫樣式 | 全站 | 用於蓋掉主題預設 CSS(最安全的客製方式) |
source/js/*.js (自建) |
你的覆寫/新增 JS | 需你在版面引用 | 放「頭像旋轉」「箭頭滑動」等自訂邏輯 |
如果之後有要修改時不知道改哪就能回來這邊確認
明天再開始進行修改